home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / bindkey.z / bindkey
Encoding:
Text File  |  2002-10-03  |  7.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))                                                          BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bindkey - function key binding facility for use with _x_w_s_h(1G)
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      bbbbiiiinnnnddddkkkkeeeeyyyy [ ----rrrr key[,binding] ... ]
  13.      bbbbiiiinnnnddddkkkkeeeeyyyy [ ----llll key[,binding] ... ]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _b_i_n_d_k_e_y is a program which provides an interface to the _x_w_s_h(1G) function
  17.      key binding facilities.
  18.  
  19.      _k_e_y is the name of a key on the keyboard; type _b_i_n_d_k_e_y without arguments
  20.      to obtain a list of valid keys.  The following are valid _b_i_n_d_k_e_y keys:
  21.  
  22.      ffff1111   ffff2222   ffff3333   ffff4444   ffff5555   ffff6666
  23.      ffff7777   ffff8888   ffff9999   ffff11110000  ffff11111111  ffff11112222
  24.      pppprrrriiiinnnntttt----ssssccccrrrrnnnn     ssssccccrrrroooollllllll----lllloooocccckkkk    ppppaaaauuuusssseeee
  25.      iiiinnnnsssseeeerrrrtttt    hhhhoooommmmeeee ppppaaaaggggeeee----uuuupppp
  26.      eeeennnndddd  ppppaaaaggggeeee----ddddoooowwwwnnnn lllleeeefffftttt----aaaarrrrrrrroooowwww
  27.      uuuupppp----aaaarrrrrrrroooowwww  ddddoooowwwwnnnn----aaaarrrrrrrroooowwww     rrrriiiigggghhhhtttt----aaaarrrrrrrroooowwww
  28.  
  29.  
  30.      _b_i_n_d_i_n_g is the text string which the key is bound to.  The text of the
  31.      binding argument must be in the printable character set.  Using the "\"
  32.      character, other character codes can be made a part of the binding.  The
  33.      following backslash sequences are supported: \n, \r, \t, \b, \\, and \xxx
  34.      where xxx is an octal number.
  35.  
  36.      It is important to remember that the binding text is interpreted by the
  37.      shell you are using before it is passed to _b_i_n_d_k_e_y on the command line
  38.      (this usually means that extra \s are required).  For remote bindings,
  39.      the text is interpreted a second time when the key bound to the text is
  40.      pressed and then interpreted by the application currently reading tty
  41.      input.  See the _c_s_h(1) and _s_h(1) man pages for rules concerning escape
  42.      sequences for special characters, such as newline (\n).
  43.  
  44.      The ----rrrr option binds the text string to the given key.  When the key is
  45.      pressed, the data is sent to the process that _x_w_s_h is managing (such as
  46.      the shell).
  47.  
  48.      The ----llll option performs the same binding as ----rrrr, except that the text
  49.      string defines a function internal to _x_w_s_h.  When the key is pressed, the
  50.      local binding is executed by _x_w_s_h directly, and not passed on to the
  51.      program that _x_w_s_h is managing.
  52.  
  53.      The set of local _x_w_s_h functions and their keywords are listed below.
  54.  
  55.      ddddoooowwwwnnnn----lllliiiinnnneeee   scroll the view one line, as if the down arrow button on the
  56.                  scroll bar was clicked.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))                                                          BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))
  71.  
  72.  
  73.  
  74.      ddddoooowwwwnnnn----ppppaaaaggggeeee   scroll the view down one page, as if the up arrow button on
  75.                  the scroll bar was clicked while the Shift key was pressed.
  76.  
  77.      eeeennnndddd         scroll the view to the bottom of the _x_w_s_h contents, as if the
  78.                  scroll bar was clicked at the bottom.
  79.  
  80.      hhhhoooommmmeeee        scroll the view to the top of the _x_w_s_h contents, as if the
  81.                  scroll bar was clicked at the top.
  82.  
  83.      ppppoooopppp         pop the window to the front.
  84.  
  85.      ppppuuuusssshhhh        push the window to the back.
  86.  
  87.      sssseeeennnndddd        send the contents of the cut buffer to the process that _x_w_s_h
  88.                  is managing.  The data is sent as if the user typed it.
  89.  
  90.      ttttoooogggggggglllleeee----rrrreeeeddddiiiirrrreeeecccctttt
  91.                  Toggle the output redirect (only valid when _x_w_s_h is run with
  92.                  the -R option).  If the _x_w_s_h output was redirected to the
  93.                  secondary device, the output is redirected back to the _x_w_s_h
  94.                  window.  If the output was directed to the _x_w_s_h window,
  95.                  redirect it to the secondary device.
  96.  
  97.      uuuupppp----lllliiiinnnneeee     scroll the view one line, as if the up arrow button on the
  98.                  scroll bar was clicked.
  99.  
  100.      uuuupppp----ppppaaaaggggeeee     scroll the view up one page, as if the up arrow button on the
  101.                  scroll bar was clicked while the Shift key was pressed.
  102.  
  103.      _x_w_s_h has the following default local bindings (see above):
  104.  
  105.           The ffff4444 key is bound to the local sssseeeennnndddd function.
  106.  
  107.           The hhhhoooommmmeeee key is bound to the local hhhhoooommmmeeee function.
  108.  
  109.           The eeeennnndddd key is bound to the local eeeennnndddd function.
  110.  
  111.           The ppppaaaaggggeeee----uuuupppp key is bound to the local uuuupppp----ppppaaaaggggeeee function.
  112.  
  113.           The ppppaaaaggggeeee----ddddoooowwwwnnnn key is bound to the local ddddoooowwwwnnnn----ppppaaaaggggeeee function.
  114.  
  115.      If no _b_i_n_d_i_n_g is provided, then _b_i_n_d_k_e_y will restore the key to its
  116.      default global binding.
  117.  
  118. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  119.      The following example of remote binding performs the command `ls -l' when
  120.      the F1 key is pressed:
  121.  
  122.           bindkey -r f1,'ls -l\n'
  123.  
  124.      The following example of local binding scrolls the _x_w_s_h display up one
  125.      line when the up-arrow on the cursor control pad is pressed.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))                                                          BBBBIIIINNNNDDDDKKKKEEEEYYYY((((1111))))
  137.  
  138.  
  139.  
  140.          bindkey -l up-arrow,up-line
  141.  
  142.      The following example reverts the binding on the F1 function key to the
  143.      system default:
  144.  
  145.           bindkey -r f1
  146.  
  147.  
  148. WWWWAAAARRRRNNNNIIIINNNNGGGG
  149.      _b_i_n_d_k_e_y provides a restricted interface which will be adjusted when the
  150.      underlying key binding facility is completed.
  151.  
  152.  
  153. NNNNOOOOTTTTEEEE
  154.      By default, xwsh key binding is disabled. See the description of the
  155.      ----bbbbiiiinnnnddddkkkkeeeeyyyy2222ddddccccssss option in the xwsh man page.
  156.  
  157. BBBBUUUUGGGGSSSS
  158.      There is currently no way to query a binding.  There is no information
  159.      around that describes what the "original default global bindings" are.
  160.  
  161. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  162.      xwsh (1G), sh (1), csh (1)
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.